Security News
Python Overtakes JavaScript as Top Programming Language on GitHub
Python becomes GitHub's top language in 2024, driven by AI and data science projects, while AI-powered security tools are gaining adoption.
hast-util-from-html-isomorphic
Advanced tools
hast utility that turns HTML into a syntax tree (while being small in browsers)
hast utility that turns HTML into a syntax tree, using browser APIs when available, so it has a smaller bundle size there.
This package is a utility that takes HTML input and turns it into a hast syntax tree.
In a browser, this uses hast-util-from-dom
,
otherwise it uses hast-util-from-html
.
If you want to get a syntax tree without positional info, and your code should be isomorphic (it could run anywhere), as it results in a smaller bundle size.
If you need positional information, use
hast-util-from-html
.
If you don’t care about positional info and your code only runs in browsers,
use hast-util-from-dom
.
Finally you can use the utility hast-util-to-html
,
or hast-util-to-dom
with .outerHTML
, to do the inverse
of this utility.
That turns hast into HTML.
This package is ESM only. In Node.js (version 16+), install with npm:
npm install hast-util-from-html-isomorphic
In Deno with esm.sh
:
import {fromHtmlIsomorphic} from 'https://esm.sh/hast-util-from-html-isomorphic@2'
In browsers with esm.sh
:
<script type="module">
import {fromHtmlIsomorphic} from 'https://esm.sh/hast-util-from-html-isomorphic@2?bundle'
</script>
import {fromHtmlIsomorphic} from 'hast-util-from-html-isomorphic'
const tree = fromHtmlIsomorphic('<h1>Hello, world!</h1>', {fragment: true})
console.log(tree)
Yields (positional info and data omitted for brevity):
{
type: 'root',
children: [
{
type: 'element',
tagName: 'h1',
properties: {},
children: [Array],
}
]
}
This package exports the identifier
fromHtmlIsomorphic
.
There is no default export.
fromHtmlIsomorphic(value[, options])
Turn serialized HTML into a hast tree.
value
(string
)
— serialized HTML to parseoptions
(Options
, optional)
— configurationTree (Root
).
Options
Configuration (TypeScript type).
fragment
Whether to parse as a fragment (boolean
, default: false
).
The default is to expect a whole document.
In document mode, unopened html
, head
, and body
elements are opened.
The following example shows the difference between parsing as a document and parsing as a fragment:
import {fromHtml} from 'hast-util-from-html-isomorphic'
const doc = '<title>Hi!</title><h1>Hello!</h1>'
console.log(fromHtml(doc))
console.log(fromHtml(doc, {fragment: true}))
…yields (positional info and data omitted for brevity):
{
type: 'root',
children: [
{type: 'element', tagName: 'html', properties: {}, children: [Array]}
]
}
{
type: 'root',
children: [
{type: 'element', tagName: 'title', properties: {}, children: [Array]},
{type: 'element', tagName: 'h1', properties: {}, children: [Array]}
]
}
👉 Note: observe that when a whole document is expected (first example), missing elements are opened and closed.
HTML is parsed according to WHATWG HTML (the living standard), which is also followed by browsers such as Chrome and Firefox.
This package is fully typed with TypeScript.
It exports the additional type Options
.
Projects maintained by the unified collective are compatible with maintained versions of Node.js.
When we cut a new major release, we drop support for unmaintained versions of
Node.
This means we try to keep the current release line,
hast-util-from-html-isomorphic@^1
, compatible with Node.js 16.
Parsing HTML is safe but using user-provided content can open you up to a
cross-site scripting (XSS) attack.
Use hast-util-santize
to make the hast tree safe.
hast-util-from-html
— parse html into hasthast-util-from-dom
— parse a DOM tree into hasthast-util-to-html
— serialize hasthast-util-sanitize
— sanitize hastxast-util-from-xml
— parse XMLSee contributing.md
in syntax-tree/.github
for
ways to get started.
See support.md
for ways to get help.
This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.
FAQs
hast utility that turns HTML into a syntax tree (while being small in browsers)
We found that hast-util-from-html-isomorphic demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Python becomes GitHub's top language in 2024, driven by AI and data science projects, while AI-powered security tools are gaining adoption.
Security News
Dutch National Police and FBI dismantle Redline and Meta infostealer malware-as-a-service operations in Operation Magnus, seizing servers and source code.
Research
Security News
Socket is tracking a new trend where malicious actors are now exploiting the popularity of LLM research to spread malware through seemingly useful open source packages.